Creazione report

Creazione report

Nel Navigatore Oggetti di ARM (oppure nel suo omologo all’interno di Fluentis) ogni oggetto ha una sezione «report» che riepiloga tutti i report collegati a quell'oggetto specifico.

Osservazione: i report personalizzati sono evidenziati in rosso:

La base per eseguire un qualsiasi report in Fluentis è un oggetto di ARM (standard o custom).

Ogni report in ARM ha:
• Un codice (univoco) che lo identifica
• Un nome (che viene visualizzato nella lista drop down nei documenti ) 
• Una descrizione
• Un contesto di esecuzione (che permette di abbinare il report ad una maschera specifica se sull’oggetto ce ne sono più di una)
• La natura (report standard/partner/custom)
• Il paese per il quale il report deve essere visibile (se vuoto = tutti i paesi)
• La/le società e la/le divisione/i per le quali il report deve essere visibile (se vuota = tutte le società + tutte le divisioni)
• L’XML che racchiude tutti gli elementi del report

Ribbon Report Designer

Il principale metodo per creare/modificare un report è il Ribbon Report Designer che è installato nella cartella Tools di Fluentis: 
[C:\Program Files (x86)\Fluentis]\Fluentis\Bin\Tools -> Produzione, Test
[C:\Fluentis\539]\Deploy\Tools -> Sviluppo

Nella stessa cartella è presente il file RibbonReportDesigner.exe.config che contiene le configurazioni personalizzate create dalle unità di lavoro di ARM.

La connessione ad ARM e lo schema di Fluentis

Sia nel caso si renda necessario creare un nuovo report, sia nel caso si debba modificare un report esistente (la creazione di un report custom a partire da uno standard può essere considerata una «modifica») la prima necessità è quella di effettuare la connessione e di selezionare quale oggetto sarà la base su cui sviluppare il nuovo report/su quale oggetto è salvato il report da modificare.

 

L’interfaccia del Ribbon

Gli elementi grafici di un report - i controlli

I controlli più utilizzati dei report sono:
• Label
• Formatted Label
• Localized Label
• Picture Box
• Line
• Cross Band Line
• Page Info

Per più dettagli sugli elementi grafici vedi Dettagli controlli report.

Gli elementi logici di un report - Campi calcolati, Formatting rules, Collections, Navigazione dei dati, ecc

Campi calcolati

Il campo calcolato è una proprietà dell’oggetto che può essere utilizzata, tramite una apposita espressione di valutazione, per restituire dati subordinandoli a determinate condizioni.
Questi campi possono essere utilizzati nel BINDING di tutti gli altri controlli (ad esempio le immagini).

Collections

Le collection sono proprietà di un oggetto che, a loro volta, contengono più oggetti dello stesso tipo. Un esempio di collection possono essere le righe di una fattura (più oggetti FSSalesInvoiceItem riferiscono allo stesso FSSalesInvoice).
E’ importante ricordare che i dati di una collection vengono esplosi e stampati solamente se in un report viene inserito un DetailReport. Diversamente verrà solamente considerata la prima riga della collection (se esistente).

Le sezioni di un report

All’interno di un report vi sono diverse sezioni nelle quali i nostri controlli possono essere inseriti (un controllo non può essere inserito al di fuori di una sezione):
• Margine di stampa alto (Top Margin)
• Testata del report (Report Header) > Stampata una volta sola all’inizio del report
• Testata della pagina (Page Header) > Stampata una volta su ogni pagina
• Testata di un raggruppamento (Group Header) > Stampata ogni volta prima di effettuare un raggruppamento di dati
• Dettaglio (Detail) > Stampata ad ogni iterazione sull’oggetto del report (NON SULLE COLLECTION)
• Report di dettaglio (Detail Report) > Permette di iterare all’interno di una collection prima di passare da un Detail al successivo
• Chiusura di un raggruppamento (Group Footer) > Stampata ogni volta dopo aver effettuato un raggruppamento di dati
• Chiusura della pagina (Page Footer) > Stampata una volta alla fine di ogni pagina
• Chiusura del report (Report Footer) > Stampata una volta sola alla fine del report
• Bottom Margin

I Parametri

Ogni report può avere parametri di input ricevute da altre fonti (da Fluentis o da un altro report). Questi parametri possono essere utilizzati, al pari dei campi, nei BINDINGS delle varie proprietà dei controlli nel report (ad esempio la lingua del documento in tutte le FORMATTED LABELS)
Fluentis passa al report alcuni parametri:
• L’ID dell’azienda (MBSC_Id)
• L’ID della divisione (MBDV_Id)
• La lingua nella quale sta venendo eseguito Fluentis (it-IT, en-US, …)
• Il titolo del report (preso dal nome presente nel dizionario)
• Il sottotitolo del report

I Subreport (Base Subreport)

Un subreport e, di fatto, l’esecuzione di un altro report che poi verrà integrato all’interno del report principale. Il report figlio può essere strutturato sullo stesso oggetto del padre o su un altro oggetto di Fluentis.

Per più dettagli sui report leggi I Subreport (base subreport).